[DEPRECATED] Add a signer to document
[DEPRECATED — will stop working in API v2] This endpoint is kept for backwards compatibility. Use POST /api/v1/documents/:id/parties instead — “party” is the correct term for a document participant.
Add a signer/participant to a document. The signer must reference an existing contact.
Signer Roles:
SIGNER- Must sign the documentORGANIZER- Document organizer (no signature required)REVIEWER- Reviews document (no signature required)ACCEPTOR- Deprecated. Still accepted on input but stored asSIGNER; never returned. Removed in v2.
Per-Signer Settings:
deliveryMethod- How to notify:EMAIL(default),SMS, orNONE(use signing URL directly)requiredSignature- Signature type:DRAWING,BANKID(Swedish BankID),CLICK_TO_SIGN,MANUAL, or a national eID scheme. eID schemes are switched on market by market — callGET /api/v1/helpers/signature-methodsfor the set your account can actually use rather than hard-coding a listtwoStepVerification- identity gate passed BEFORE the document opens:NONE(default),PIN_BEFORE_SIGNING,SMS_BEFORE_SIGNING,EMAIL_BEFORE_SIGNING, or an eID gate such asBANKID_BEFORE_SIGNING— callGET /api/v1/helpers/two-step-verificationsfor the live list
Signing Order: For SEQUENTIAL signing, specify the order (1, 2, 3…). For PARALLEL signing, order is ignored.
Response: Returns the created signer. Use GET /documents/:id/signers/:signerId to retrieve the signing URL.
Authorizations
Headers
Body
Body
Create signer request
Two-step verification: NONE (default), SMS_BEFORE_SIGNING, EMAIL_BEFORE_SIGNING, or BANKID_BEFORE_SIGNING
NONE, SMS_BEFORE_SIGNING, EMAIL_BEFORE_SIGNING, PIN_BEFORE_SIGNING, SE_BANKID_BEFORE_SIGNING, NO_BANKID_BIOMETRIC_BEFORE_SIGNING, NO_BANKID_HIGH_BEFORE_SIGNING, DK_MITID_BEFORE_SIGNING, DK_MITID_ERHVERV_BEFORE_SIGNING, FI_FTN_BEFORE_SIGNING, NL_IDIN_BEFORE_SIGNING Response
200
Two-step verification: NONE, SMS_BEFORE_SIGNING, EMAIL_BEFORE_SIGNING, or BANKID_BEFORE_SIGNING
NONE, PIN_BEFORE_SIGNING, SMS_BEFORE_SIGNING, EMAIL_BEFORE_SIGNING, BANKID_BEFORE_SIGNING, NO_BANKID_BIOMETRIC_BEFORE_SIGNING, NO_BANKID_HIGH_BEFORE_SIGNING, DK_MITID_BEFORE_SIGNING, DK_MITID_ERHVERV_BEFORE_SIGNING, FI_FTN_BEFORE_SIGNING, NL_IDIN_BEFORE_SIGNING True when an eID completed, the identity did not match the intended signer, and the signature was still recorded — read GET /api/v1/documents/{id}/signatures to see what differed. Stays false when the workspace requires an SSN match to sign and the attempt was refused, because no signature exists; those attempts appear only in the document audit trail.

